home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / mus / misc / modulein.lha / ModuleInfo / ModuleInfo.doc < prev    next >
Encoding:
Text File  |  1995-06-01  |  3.9 KB  |  114 lines
  1. ---------------------------------------------------------------------------
  2.                             ModuleInfo 0.8                        31-May-95
  3. ---------------------------------------------------------------------------
  4.  
  5. Introduction
  6. ~~~~~~~~~~~~
  7. ModuleInfo is a small program that will help you to change the songname,
  8. and instrument names of a ST/NT/PT-Module.
  9.  
  10. I programmed this small utility because I was changing the instrument
  11. names in lots of modules, and I'm too lazy to do it all by hand..
  12.  
  13. You can of course change these things by loading the module into ProTracker,
  14. but it's much easier with ModuleInfo.
  15.  
  16. ModuleInfo also has support for unpack.library by SHI (included), so you
  17. can load a lot of kinds of packed modules without having to decrunch them
  18. by hand.
  19.  
  20. Disclaimer
  21. ~~~~~~~~~~
  22. THIS SOFTWARE AND INFORMATION IS PROVIDED "AS IS". NO REPRESENTATIONS OR
  23. WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY, RELIABILITY, PERFORMANCE,
  24. CURRENTNESS, OR OPERATION OF THIS SOFTWARE AND INFORMATION, AND ALL USE IS
  25. AT YOUR OWN RISK. THE AUTHOR DOES NOT ASSUME ANY RESPONSIBILITY OR LIABILITY
  26. WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE AND INFORMATION.
  27.  
  28. Copyright
  29. ~~~~~~~~~
  30. This program is FREEWARE. It may be freely distributed as long as all files
  31. in it remain unchanged and are included in the distribution. Also no more
  32. than a nominal copy fee may be charged for the distribution. This program
  33. cannot be used for commercial purposes without written permission from the
  34. author.
  35.  
  36. Installing
  37. ~~~~~~~~~~
  38. Copy these libraries to LIBS:
  39.  
  40. gadutil.library   -  This is required by the program.
  41.  
  42. unpack.library    -  This is not required, but if you have this, the program
  43.                      will be able to decrunch the modules.
  44.  
  45.  
  46. Function
  47. ~~~~~~~~
  48. I programmed ModuleInfo because I wanted an easier way to change the sample/
  49. song-names of an ST/NT/PT-module.
  50.  
  51. This could be done with a hex-editor, but then there's always a risk that you
  52. edit something that you shouldn't have edited.
  53.  
  54. Why I wanted to change the modulenames was:
  55.  
  56. In lots of old modules, the author has written his name in a way that is not
  57. standard for the author name. So those programs that recognise the name will
  58. not work.
  59.  
  60. The standard way of doing this is to use the #-sign, followed by the name of
  61. the author, as the first samplename.
  62.  
  63. Like this:
  64.  
  65. 1: #Heatbeat / Carillon         ; This is the name of the author
  66. 2:                              ; These other sample names
  67. 3: This beat was composed       ; can be used for other comments,
  68. 4: in january 1995.             ; like this.
  69.  
  70. The program will also load packed modules, so there's no need to decrunch
  71. these modules before loading.
  72.  
  73. The gadgets:
  74.  
  75. Name:           This shows the name of the module (filename)
  76. Requester:      This brings up a file-requester (load file).
  77. Save:           Saves the file. You can select another name if you like.
  78. About:          An about requester..
  79. Song Name:      The real name of the song. (The name that's in the module).
  80.  
  81. The rest of the gadgets are for the sample names.
  82.  
  83.  
  84. Usage
  85. ~~~~~
  86. An example:
  87.  
  88. 1) Start the program ;)
  89. 2) Click on the requester gadget (the one to the right of the name gadget.
  90. 3) Select a module to load
  91. 4) Change the samplenames / songname.
  92. 5) Select Save
  93. 6) Choose a name for the module
  94.  
  95.  
  96. If you load something that's not a module, or the module can't be decrunched,
  97. the sample names will look strange. If this happens, don't save the module.
  98. If the loaded file is a ST/NT/PT-module that's packed with some kind of
  99. unknown packer, use a decrunch program for that cruncher to decrunch it.
  100.  
  101. If the module can't be decrunched, another probable cause is that you don't
  102. have the unpack.library installed.
  103.  
  104. If the file is not a module, just load a real module...
  105.  
  106.  
  107.  
  108.              Send bug reports, ideas, PD Programs etc. to:
  109.  
  110.                            Staffan Hämälä
  111.                            Pellov. 268
  112.                            S-957 93 Pello
  113.                            SWEDEN
  114.